//
//
// Copyright 2015 gRPC authors.
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//     http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
//
//

#ifndef GRPC_CORE_LIB_GPRPP_HOST_PORT_H
#define GRPC_CORE_LIB_GPRPP_HOST_PORT_H

#include <grpc/support/port_platform.h>

#include <string>

#include "absl/strings/string_view.h"

namespace grpc_core {

// Given a host and port, creates a newly-allocated string of the form
// "host:port" or "[ho:st]:port", depending on whether the host contains colons
// like an IPv6 literal.  If the host is already bracketed, then additional
// brackets will not be added.
std::string JoinHostPort(absl::string_view host, int port);

/// Given a name in the form "host:port" or "[ho:st]:port", split into hostname
/// and port number.

/// There are two variants of this method:
/// 1) absl::string_view output: port and host are returned as views on name.
/// 2) std::string output: port and host are copied into newly allocated
/// strings.

/// Prefer variant (1) over (2), because no allocation or copy is performed in
/// variant (1).  Use (2) only when interacting with C API that mandate
/// null-terminated strings.

/// Return true on success, false on failure. Guarantees *host and *port are
/// cleared on failure.
bool SplitHostPort(absl::string_view name, absl::string_view* host,
                   absl::string_view* port);
bool SplitHostPort(absl::string_view name, std::string* host,
                   std::string* port);

}  // namespace grpc_core

#endif  // GRPC_CORE_LIB_GPRPP_HOST_PORT_H
